home *** CD-ROM | disk | FTP | other *** search
/ Greenhouse Effect Detection Expriment / NASA Greenhouse Effect Detection Expriment 1992 - Disc 2.iso / software / dos / cdflist.hlp < prev    next >
Encoding:
Text File  |  1992-03-14  |  4.9 KB  |  83 lines
  1. The CDFlist program allows you to selectively list all (or a subset of) the
  2. variable data values from a CDF.  The values can be displayed at the
  3. screen, output to a text file, or used to create a new CDF (the new CDF may
  4. be a subset of the original CDF).
  5.  
  6. The user interface to CDFlist is contained on a single screen which is
  7. divided into several fixed windows and pop-up windows.  The Action Menu
  8. controls the execution of the program.  This menu allows you to move to a
  9. different window, start the data output, browse a help file, or exit the
  10. program.  You must return to this menu each time you want to select a new
  11. variable, output option, listing type, or input CDF.  This menu may be
  12. displayed at any time by entering Ctrl-F.  Use the up and down arrow keys
  13. to highlight a choice in the Action Menu and then enter a carriage return
  14. to execute that function.  Two very important windows are the Keypad
  15. Definition and Message windows.  They contain information on keypad
  16. functionality and program status/error messages.
  17.  
  18. When CDFlist is executed (and a CDF and/or directory is not entered on the
  19. command line), you must first specify the CDF you wish to list.  If you
  20. enter a full disk/directory specification (without a CDF name), all of the
  21. CDFs in the specified directory will appear in a separate pop-up window.
  22. Use the up and down arrow keys to choose a CDF, and then enter a carriage
  23. return to list that CDF.
  24.  
  25. The Output window will then be displayed with the valid choices.  Use the
  26. up and down arrow keys to scroll up and down within the menu and then enter
  27. a carriage return to select the desired output option.  If output to an
  28. ASCII file or CDF is selected, you will be prompted for a file/CDF name.
  29. You may enter any file/CDF name valid for the operating system being used
  30. or accept the default file/CDF name that appears.  Do not enter a file
  31. extension (it is automatically appended).  The file extension for a
  32. generated text file is .dat.
  33.  
  34. The second window that remains constant on the screen is the Variable
  35. Selection window.  This window allows the user to select the variables that
  36. are to be listed or put into a CDF along with any desired filters on the
  37. variables.  You will automatically be placed in this window after you have
  38. entered an output option.  You can also enter this window by entering
  39. Ctrl-F to bring up the Action Menu and then select the Select Variables
  40. menu option.
  41.  
  42. There are three fields on each line in the Variable Selection window:
  43. variable name, minimum filter value, and maximum filter value.  You can
  44. move forward to the next field by entering a carriage return or backwards
  45. to the previous field with a Ctrl-H.  You may also use the up and down
  46. arrow keys to move vertically through the fields.  When the cursor is
  47. positioned in a variable name field, entering Ctrl-P will display the
  48. variables in the CDF in a pop-up window.  Use the arrow keys to highlight a
  49. variable and then enter a carriage return to select it.  You can quit the
  50. pop-up window without selecting a variable by entering q (quit).  You may
  51. also use the u and d keys to page up and down in the pop-up window.  The
  52. first line in this pop-up menu contains **SELECT ALL**. Selecting this item
  53. causes all of the variables in the CDF to be selected.
  54.  
  55. After selecting a variable, the cursor is positioned in the minimum filter
  56. field.  A filter is simply the range of data that you would like to see
  57. from the selected variable.  If just specifying a minimum filter value is
  58. sufficient, a maximum filter value need not be entered.  You do not have to
  59. enter a filter for each selected variable.  For a line of output (or a set
  60. of CDF variable values) to be written for a given record/indices, each
  61. filter must be passed.  There are two ways to enter minimum and maximum
  62. filters.  The first is by simply entering the desired values in the
  63. appropriate fields.  The second method can only be used for variables that
  64. consist of a discrete set of values.  This method involves entering a
  65. Ctrl-P (when in the desired filter field) which displays a pop-up window
  66. that contains the discrete values for the variable.  The desired filter
  67. value may then be selected.
  68.  
  69. When all of the desired variables and filters have been selected, enter
  70. Ctrl-F to display the Action Menu.  Selecting "Generate Output" will cause
  71. the listing or new CDF to be generated.  When CDFlist completes the
  72. generation of the output, the Action Menu is redisplayed. It may then be
  73. used to select a new CDF to list, respecify the output option, select new
  74. variables/filters, get online help, or exit the program.
  75.  
  76. NOTE:
  77.  
  78. If you are running CDFlist under UNIX, your terminal output will be limited
  79. to 132 characters per line.  If too many variables have been selected, the
  80. output to a terminal screen will be truncated. Output to a file or CDF,
  81. however, will not be affected (as many variables as desired may be
  82. selected).
  83.